home *** CD-ROM | disk | FTP | other *** search
/ MACD 5 / MACD 5.bin / workbench / wb / czesc_2 / execmaster / execmaster.doc < prev    next >
Encoding:
Text File  |  1992-10-12  |  13.6 KB  |  560 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                              DOCUMENTATION
  12.  
  13.  
  14.                 ExecMaster  VERSION  1.7   FREEWARE VERSION
  15.  
  16.  
  17.                            written  1992 by H.P.G.
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63. INDEX:
  64.  
  65.  
  66.         Index                           Page    2
  67.  
  68.         Genearl Description                     3
  69.  
  70.         SYSTEM                                  3
  71.  
  72.         Legal Stuff                             4
  73.  
  74.         Features                                5
  75.  
  76.         Installation                            5
  77.  
  78.         Starting ExecMaster                     6
  79.  
  80.         ExecMaster Start PARAMETERs             7
  81.  
  82.         Description of the Intuition Interface  8,9
  83.  
  84.         Technical                               10
  85.  
  86.         Last                                    10
  87.  
  88.         Address                                 10
  89.  
  90.  
  91.         Append:
  92.  
  93.  
  94.                 List of Files
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116. General Description:
  117.  
  118.  
  119.         ExecMaster [ EM ] is a program which is an enhancement  for  the
  120.         menuitem 'Execute Command' of the WBench 2.xx.
  121.  
  122.         - With EM you can execute Cli  commands,  ARexx  scripts,  batch
  123.           scripts or just programs.
  124.  
  125.         - The output can be redirected
  126.  
  127.         - With EM you can easily edit batch files.
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134. SYSTEM:
  135.  
  136.  
  137.  
  138.         For EM you need at minimum Kickstart 2.xx and ASL.Library 37.xx.
  139.  
  140.         You must have Run and Execute in your current AmigaDOS searchpath
  141.  
  142.  
  143.         If you want to use all functions of EM you should also have  the
  144.         Rx command in your searchpath.
  145.  
  146.  
  147.  
  148.  
  149.         NOTIZ: Because of EM`s use of the new OS 2.0 features EM is  not
  150.                able to run under 1.2 1.3 .
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159. Legal Stuff:
  160.  
  161.  
  162.         This program and all files come with it also the docfiles are released
  163.         as FREEWARE.
  164.  
  165.         this means:
  166.  
  167.             everybody may use ExecMaster,
  168.  
  169.             everybody may copy ExecMaster, if:
  170.  
  171.                 1. you copy all included files see list below
  172.                 2. no changes are made , this means the program amd all included files
  173.                    must stay in the origin form. Exception: you may archieve it ; but
  174.                    in this way you must also archieve the whole package.
  175.                 3. if you recompile it, you have to include a notice to the original
  176.                    author. if you also want to (re)distribute in this form you have to
  177.                    send me a copy.
  178.                 4. you may not sell ExecMaster
  179.                        except:   you`re allowed to take a small copy fee which
  180.                                  may not extend 5$.
  181.                 5. if you want to include ExecMaster or one of the included files as a part
  182.                    of a commercial package, you must have written permission of the
  183.                    author (address see below)
  184.  
  185.  
  186.         I take no warranty or garanty for the function of this program.
  187.         The whole risk of using it stays by the user.
  188.  
  189.  
  190.  
  191.  
  192.         (But I don`t think there are many bugs in this program)
  193.  
  194.  
  195.  
  196.  
  197.  
  198.         Now we come to the more interesting part:
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211. FEATURES:
  212.  
  213.  
  214.         - EM has a full mousedriven GadTools userinterface.
  215.  
  216.         - All functions are also available by pressing several keys
  217.  
  218.         - You can specify whole command lines.
  219.  
  220.         - You can execute ARexx scripts.
  221.  
  222.         - You can execute batch scripts.
  223.  
  224.         - You can call other programs.
  225.  
  226.         - You can redirect the Output to anything you want.
  227.  
  228.         - EM has the ability to iconify.
  229.  
  230.         - Also if EM is iconified, all functions are still available  by
  231.           pressing keys.
  232.  
  233.         - All commands and/or programs can be selected by use of the ASL
  234.           filerequester.
  235.  
  236.         - All settings of the main and the iconfied window  can  be  set
  237.           via commandline parameters.
  238.  
  239.         - You can specify the width of the iconified window at starttime.
  240.  
  241.         - Several default options can be set also at starttime.
  242.  
  243.         - There are also some keycodes for  system  gadgets  (ZoomGadget
  244.           CloseGadget)
  245.  
  246.         - Full support of public screens. That means EM opens its window
  247.           always on default PublicScreen.
  248.  
  249.         - All gadgets have org. WB 2.xx design und function.
  250.  
  251.         - No BUSY-LOOPS
  252.  
  253.  
  254.  
  255.  
  256. Installation:
  257.  
  258.  
  259.         Just copy ExecMaster into your C: or any other dir in your current
  260.         AmigaDOS searchpath.
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270. Starting ExecMaster:
  271.  
  272.  
  273.  
  274.         EM must be startet from CLI, if you want to specify any parameter.
  275.         Alternativly you can use the WBenchmenuitem 'ExecuteCommand'  to
  276.         call EM.
  277.  
  278.         Certainly you can use ExecMaster via doubleclick  on  its  icon,
  279.         but in this case EM use its defaults.
  280.  
  281.         If you want to call ExecMaster  via  doubleclick  and  give  any
  282.         arguments to it it is very useful to create a project icon.  Add
  283.         as DefaultTool 'c:IconX' and save it under the name 'EMaster.info'.
  284.  
  285.         Then type in the text
  286.         e.g.
  287.  
  288.  
  289.                ExecMaster CMD dir df0: ICONIFY
  290.  
  291.  
  292.         If you saved this text as e.g. EMaster  and  set  the  s-bit  by
  293.         typing 'protect EMaster +s' in the  Cli  you  can  start  EM  by
  294.         doubleclicking on the EMaster icon.
  295.  
  296.         A disadvantage herefor is that the window of IconX  stays  until
  297.         EM finished. but if you type in EMaster
  298.  
  299.  
  300.  
  301.               RUN >NIL: ExecMaster .......
  302.  
  303.  
  304.         you can provide that. Therefor you mast take care that you  must
  305.         specify an output for EM (see below) if you want to get any output.
  306.  
  307.  
  308.  
  309.  
  310.         An example call:
  311.  
  312.  
  313.               RUN >NIL: ExecMaster OUTP "CON:0/0///EM_Output/WAIT" OUTON
  314.  
  315.  
  316.         The Wait flag causes the window to close after you put in 'ctrl-\'.
  317.         If you donot specify WAIT the window closes suddenly after executing
  318.         any command. If you use the WAIT flag you will get time to read the
  319.         informations in the window first.
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327. ExecMaster START PARAMETERs:
  328.  
  329.  
  330.         EM has the following
  331.  
  332. Syntax:   ExecMaster  CMD/K,OUTP/K,ICONIFY/S,OUTON/S,X/N,Y/N,ZX/N,ZY/N,ZW/N
  333.  
  334. with:
  335.  
  336. *       CMD           String           if you specify CMD following by a string
  337.                                        the string will be copied to the command
  338.                                        StringGadget. (see below)
  339.  
  340. *       OUTP          String          ›if you specify OUTP following by a string
  341.                                        this string will be copied to the output
  342.                                        StringGadget (s.b.)
  343.  
  344. *       ICONIFY       ------------     if you specify ICONIFY EM starts iconfied
  345.  
  346.  
  347. *       OUTON         ------------     if you specify OUTON the CheckBox will be
  348.                                        selected. If this Checkbox is selected
  349.                                        all Output will be sent to the contents
  350.                                        of the output StringGadget.
  351.                                        Default: CheckBox unselected
  352.  
  353. *       X             Number           if you specify x following by a number
  354.                                        EM opens its window with its leftedge
  355.                                        depending on this value.
  356.  
  357. *       Y             Number           specifies the topedge of the window
  358.  
  359. *       ZX            Number           specifies the leftedge of the iconified
  360.                                        window.
  361.  
  362. *       ZY            Number           specifies the topedge of the iconified
  363.                                        window
  364.  
  365. *       ZW            Number           specifies the width of the iconified
  366.                                        window.
  367.                       361 > ZW > 119   Its value must be between 120 and 360,
  368.                                        otherways it will be ignored.
  369.                                        With this argument you can prevent you
  370.                                        from ugly holes on your ScreenTitle
  371.                                        when you have also other programs with
  372.                                        iconified windows running while using
  373.                                        EM.
  374.  
  375.  
  376. *** Starting EM without any PARAMETER or from WBench by doubleclicking, the
  377. *** command StringGadget stays empty. The CheckBox is always selected. The
  378. *** iconified window first appears always on coords 0,0; the main window
  379. *** appears in the middle of the screen
  380.  
  381. Description of the Intuition Interface:
  382.  
  383.  
  384.             Following is a description of the functions of EM and their
  385.             usage:
  386.             ( Characters in the '[]'s represents the keys you can
  387.               use instead of activating the gadget )
  388.  
  389.     Command [c|C] (Pressing c or C)
  390.  
  391.         This activates the command StringGadget. You  can  type  in  the
  392.         name of the command you want to execute. If you  press  the  TAB
  393.         key instead of the RETURN key, the  next  StringGadget  will  be
  394.         activated. If you press Shift-TAB the  previous  one   will   be
  395.         activated.
  396.  
  397.     Output  [o|O]
  398.  
  399.             This activates the output StringGadget. You can type in  the
  400.         output you want the command to use. You can type in  there  e.g.
  401.         simply 'CON:' to get the default CON: window. You can also  type
  402.         in a filename where all outputs of the command will be sent  to.
  403.         E.G.
  404.  
  405.                 if you specify 'Ram:File' as output,
  406.  
  407.                          and 'dir c:' as command, you get the file
  408.                          'Ram:File' which contains all filenames of the
  409.                          c: dir.
  410.  
  411.  
  412.                     ......
  413.                     addbuffers
  414.                     avail
  415.                     ......
  416.  
  417.             If you want no output you can deselect the CheckBox (s.b.)
  418.             or type NIL: in the output StringGadget.
  419.  
  420.             Input cannot be indirected.
  421.  
  422.  
  423.     | |     [+]
  424.  
  425.             The CheckBox (on the right hand side of  the  output  String
  426.         Gadget) specifies if EM should use the contents  of  the  output
  427.         StringGadget as output for the command or not. If  the  CheckBox
  428.         is selected the output will be used. This is useful if you  want
  429.         to try out different outputs or you want  to  write  a  list  of
  430.         files. So first you can inactivate the CheckBox and then type in
  431.         the name of the destinationfile in the output StringGadget. Then
  432.         type in the command StringGadget e.g. List . If you execute this
  433.         by pressing Cmd (s.b.) the list of the files appears in the  Cli
  434.         window EM is started from. If you want  to  write  this  listing
  435.         then to file you can activate the CheckBox and the  output  will
  436.         be sent to the filename.
  437.  
  438.  
  439.     RUN     [r|R]
  440.  
  441.             If you chose Run the command will be executed via C:Run as a
  442.         backgroundprocess. Also in this case all output will be sent  to
  443.         the specified output.
  444.  
  445.     Script  [s|S]
  446.  
  447.             With Script you can start a batch script. This  script  will
  448.         be executed by calling C:Execute. This is useful to execute batch
  449.         files which have not not set their S-Bit. If their S-Bit is  set
  450.         you can simply use Cmd (s.b).
  451.  
  452.     Rexx    [x|X]
  453.  
  454.             This starts a Rexx script by calling the Rx  commmand.  this
  455.         should be located in the REXX: Assign or in any other  place  in
  456.         your AmigaDOS searchpath (usually its in sys:Rexxc)
  457.  
  458.     Select  [e|E]
  459.  
  460.             This opens the ASLFileRequester that lets you select a  file
  461.         which will be prompted in the command StringGadget.
  462.  
  463.     Cmd     [m|M]
  464.  
  465.             This executes the contents of the command StringGadget as  a
  466.         whole command line (unchanged). You can here specify not only  a
  467.         command you can also type in a whole command line with arguments
  468.         and parameters.
  469.  
  470.         e.g: you can type in:
  471.  
  472.                     'list df0:system/setm#?'    or
  473.  
  474.                     'hdtoolbox'
  475.  
  476.     Any output will be sent to the specified output.
  477.  
  478.  
  479.     Iconify [i|I]
  480.  
  481.             This  (re)iconifies  the  window.  You  can  therefor   also
  482.         activate the ZoomGadget of the window. After (first) iconifying a
  483.         little window appears on the left upper corner of  your  screen.
  484.         Typing i or activating the ZipGadget again will bring  back  the
  485.         old window on the old position.
  486.  
  487. Note:   Especially if the window is iconified you`ll see the advantage of
  488.         the EM`s key command support. All  functions  of  EM  are  still
  489.         available although you can`t see any gadgets yet. Its  like  you
  490.         get a very small full functionally Cli window. (great ey ?)
  491.  
  492.     Quit    [q|Q]
  493.             Quits the program. You can also use 'q' or the CloseGadget of
  494.             the window
  495.  
  496.  
  497.  
  498. Technical:
  499.  
  500.  
  501.         EM is written with the Manx Aztec C V 5.2a - Compiler
  502.  
  503.  
  504.         EM uses the new DOS functions ReadArgs  for  CommandLineParsing.
  505.         The Intuition interface is created and managed by  the  GadTools
  506.         Library The FileRequester is from the ASL.Library.
  507.  
  508.  
  509. Last:
  510.  
  511.         Ich hope EM will be used by a lot of people. If  you  find  bugs
  512.         send me a message. Also serious critic and/or ideas are wellcomed.
  513.  
  514. Address:
  515.  
  516.  
  517.     Send all messages to:
  518.  
  519.  
  520.  
  521.                 Hans - Peter Guenther
  522.  
  523.                 Gruener Weg 5
  524.  
  525.                 3501 Fuldatal 2
  526.  
  527.                 ( B.R.D )
  528.  
  529.  
  530. Have fun ...
  531.  
  532.                 H.P.G
  533.  
  534. PS:
  535.  
  536. List of files:
  537.  
  538. (If you miss any of the files below you release is incomplete)
  539.  
  540. ExecMaster           : binary
  541. ExecMaster.info
  542. ExecMaster.dok       : german manual
  543. ExecMaster.dok.info
  544. ExecMaster.doc       : english manual
  545. ExecMaster.doc.info
  546. Examples (Dir)
  547.         .edrc.dme         : part of a DMe startup file
  548.         .edrc.dme.info
  549.         Csh.start.sh      : part of a Csh startup file
  550.         Csh.start.sh.info
  551.         EMaster           : batch file
  552.         EMaster.info
  553.         User-Startup      : part of a user-startup file
  554.         User-Startup.info
  555. Examples.info
  556.  
  557. ---
  558. END
  559.  
  560.